home *** CD-ROM | disk | FTP | other *** search
/ Aminet 28 / Aminet 28 (1998)(GTI - Schatztruhe)[!][Dec 1998].iso / Aminet / comm / mmgr / MM_ShoveMsgs06.lha / Docs / MM_ShoveMsgs.doc < prev    next >
Encoding:
Text File  |  1997-07-28  |  6.2 KB  |  213 lines
  1.  
  2.  
  3.  
  4.                              MM_ShoveMsgs v0.6
  5.  
  6.                             ©1997 Neil Williams
  7.  
  8.  
  9.  
  10. Introduction
  11. ~~~~~~~~~~~~
  12. MM_ShoveMsgs is an echo gating tool for Mail Manager  v1.2  or  better.  It
  13. allows  people in two (or more) echoes/networks to share messages with each
  14. other.
  15.  
  16. MM_ShoveMsgs   was   written   with   the   help   of   Robert    Hofmann's
  17. MM_RexxDevelopperKit,  which made writting this much easier! Thanks Robert!
  18. :)
  19.  
  20. This program is now shareware - if you like it you  should  send  £5  (Five
  21. pounds  Sterling)  to the address below. You do not need to do this, as the
  22. program is fully usable and you won't get anything in return for your money
  23. (except  maybe  a  "thank you" netmail). I would however like people who do
  24. use this program to at least send me a netmail or e-mail and tell me, so  I
  25. can see that people are actually using my programs.
  26.  
  27.  
  28.  
  29. Legal Stuff
  30. ~~~~~~~~~~~
  31. THE MM_SHOVEMSGS PACKAGE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS `AS IS'
  32. WITHOUT  WARRANTY  OF  ANY KIND, EITHER EXPRESSED OR IMPLIED INCLUDING, BUT
  33. NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
  34. PARTICULAR  PURPOSE  ARE  DISCLAIMED. THE ENTIRE RISK AS TO THE ACCURACY OF
  35. THE INFORMATION HEREIN IS ASSUMED BY YOU. IN NO EVENT SHALL THE  AUTHOR  OR
  36. CONTRIBUTORS  BE  LIABLE  FOR  ANY  DIRECT,  INDIRECT, INCIDENTAL, SPECIAL,
  37. EXEMPLARY,  OR  CONSEQUENTIAL  DAMAGES  (INCLUDING,  BUT  NOT  LIMITED  TO,
  38. PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS;
  39. OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY  THEORY  OF  LIABILITY,
  40. WHETHER  IN  CONTRACT,  STRICT  LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
  41. OTHERWISE) ARISING IN ANY WAY OUT OF THE USE  OF  THIS  SOFTWARE,  EVEN  IF
  42. ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  43.  
  44. This program may not be converted for use with any other mail editor/tosser
  45. without the authors permission.
  46.  
  47.  
  48.  
  49. Author
  50. ~~~~~~
  51. Neil Williams @ 2:442/107.0
  52.                 39:136/1.0
  53.                 y025437neil@yale.ac.uk
  54.                 now2@frost3.demon.co.uk
  55.  
  56. The Killing^Ground, 22:00 until 08:00 GMT on +44 (0)1978 751393
  57.  
  58. If you wish to send the shareware fee, send cash or a cheque (or  something
  59. that can be withdrawn at a UK bank) for £5 (Five UK pounds) to :
  60.  
  61.     Neil Williams
  62.     (MM Utils)
  63.     23 Kent Road
  64.     Lodge
  65.     Wrexham
  66.     LL11 5NW
  67.     Great Britain
  68.  
  69. Make cheques payable to Neil Williams.
  70.  
  71.  
  72.  
  73. ToDo
  74. ~~~~
  75. Speed it up!
  76.  
  77. Anything anyone suggests...
  78.  
  79. Fix the only known bug : Messages written by the SysOp will NOT  be  gated.
  80. You'll need to crosspost your own messages across for the moment.
  81.  
  82. Gated messages don't have the correct date (they have the date & time  they
  83. were  gated.)  I  don't  think  it  will be possible to fix this, but every
  84. message has a kludge "DATED: ..." which is the origional date.
  85.  
  86.  
  87.  
  88. Installation
  89. ~~~~~~~~~~~~
  90. Depack the archive to "MM:/" (i.e. the parent  directory  of  MM>,  or  you
  91. could dearchive it to RAM: and copy the files across manually..
  92.  
  93. The  areas  you  intend  to  gate  must  be  set   to   Two   Pass   Import
  94. (Areas/Messages/Misc/Two  Pass  Import)  and  this script called before the
  95. area is exported!
  96.  
  97. For example, if you are using MM_ImportPlus (and if not, why not? :) put in
  98. an #ECHOMAILCMD like this:
  99.  
  100. #ECHOMAILCMD rx MM:Rexx/MM_ShoveMsgs
  101.  
  102.  
  103.  
  104. Configuration
  105. ~~~~~~~~~~~~~
  106. This is done by the text file "MM:Config/MM_ShoveMsgs.CFG"
  107.  
  108.   #GATEENTRY <name>
  109.   -----------------
  110.  
  111.   This defines the start of a  single  gate.  <name>  can  be  anything  to
  112.   identify the gate. There may be more than one #GATEENTRY in order to have
  113.   more pairs of echoes being gated between, but each #GATEENTRY  must  have
  114.   *ALL* the following parameters following it, each on a new line. (See the
  115.   example configuration below)
  116.  
  117.        OneArea   <echo tag>
  118.        --------------------
  119.  
  120.        One of the areas of which to gate in this pair.
  121.  
  122.        OneAddress   <address>
  123.        ----------------------
  124.  
  125.        The address of the echo  defined  in  OneArea.  Full  5D  format  is
  126.        needed. (This item /may/ be removed in the future)
  127.  
  128.        OneFlags     (WriteOnly|ReadOnly|TwoWay)
  129.        ----------------------------------------
  130.  
  131.        The flags applied to this area:
  132.  
  133.            WriteOnly : Messages can be written to the area, but NOT read
  134.                        from it.
  135.  
  136.            ReadOnly  : Messages can be read from the area, but it may NOT
  137.                        be written to.
  138.  
  139.            TwoWay    : The area can be both read from and written to.
  140.  
  141.        Use common sense when choosing flags - If one is  TwoWay,  then  the
  142.        other will be as well; both cannot be Read or Write Only; etc.
  143.  
  144.        TwoArea   <echo tag>
  145.        --------------------
  146.  
  147.        The second gate of the pair.
  148.  
  149.        TwoAddress   <address>
  150.        ----------------------
  151.  
  152.        The address of the echo  defined  in  TwoArea.  Full  5D  format  is
  153.        needed. (This item /may/ be removed in the future)
  154.  
  155.        TwoFlags     (WriteOnly|ReadOnly|TwoWay)
  156.        ----------------------------------------
  157.  
  158.        The flags applied to this area:
  159.  
  160.            WriteOnly : Messages can be written to the area, but NOT read
  161.                        from it.
  162.  
  163.            ReadOnly  : Messages can be read from the area, but it may NOT
  164.                        be written to.
  165.  
  166.            TwoWay    : The area can be both read from and written to.
  167.  
  168.        Origin   <text>
  169.        ---------------
  170.  
  171.        This is the origin used on every message gated in this pair. Usually
  172.        something like "<Node name>: <This>Net <-> <That>Net GateWay"
  173.  
  174.  
  175.  
  176. Example Configuration:
  177. ~~~~~~~~~~~~~~~~~~~~~~
  178.  
  179. >------ Start : MM:Config/MM_ShoveMsgs.CFG --------------------------------
  180.  
  181. ;
  182. #GATEENTRY Test
  183. OneArea     WORKBENCH
  184. OneAddress  2:442/107.0@fidonet
  185. OneFlags    ReadOnly
  186. TwoArea     SHOVEMSG_TEST
  187. TwoAddress  978:2/7.0@wcn
  188. TwoFlags    WriteOnly
  189. Origin      TK^G - FidoNet <-> WCNet GateWay
  190.  
  191. #GATEENTRY Test2
  192. OneArea     W_ANYTHING
  193. OneAddress  978:2/7.0@wcn
  194. OneFlags    TwoWay
  195. TwoArea     SHOVEMSG_TEST2
  196. TwoAddress  13:661/107.0@sportsnet
  197. TwoFlags    TwoWay
  198. Origin      TK^G - WCNet <-> SportsNet GateWay
  199.  
  200. >------ End : MM:Config/MM_ShoveMsgs.CFG ----------------------------------
  201.  
  202.  
  203.  
  204. Usage
  205. ~~~~~
  206.  
  207.       [RX] MM_ShoveMsgs[.rexx]
  208.  
  209. There are no command line options.
  210.  
  211. See the installation instructions for more proper usage.
  212.  
  213.